home *** CD-ROM | disk | FTP | other *** search
/ The World of Computer Software / The World of Computer Software.iso / tbt316.zip / TURBOBAT.MAN < prev    next >
Text File  |  1992-11-27  |  38KB  |  1,136 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9. ExtraDOS Toolbox (tm)
  10. _______________________________________
  11.  
  12.   Users Manual
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33. Copyright (c) 1985-92 Foley Hi-Tech Systems (ASP)  All Rights Reserved
  34.  
  35.  
  36. Introduction
  37. _____________________________________________________________________
  38.  
  39.  
  40. ExtraDOS Toolbox is a compilation of tools useful to Microsoft DOS
  41. users.  I originally wrote the first version of ExtraDOS under MS-DOS
  42. because I found a need for them and there were no commercially
  43. available products that provided these functions.  Some ExtraDOS tools
  44. were designed to enhance programs already found in MS-DOS.  Other
  45. tools were familiar to the Unix world, but were not available in
  46. MS-DOS.  Over the years this collection has grown into large group of
  47. very useful tools.  Some of these utilities are duplicates of those
  48. found elsewhere, but often provide much better features or reduced
  49. memory overhead than similar utilities found elsewhere.  In addition,
  50. ExtraDOS complements PC-Tools and Norton Utilities with added tools
  51. these programs do not provide.
  52.  
  53. Over thirty of the ExtraDOS Toolbox utilities have been selected by
  54. Paul Somerson, former Executive Editor of PC Magazine, for Bantam
  55. Books', DOS Power Tools, 2nd Edition, Revised and Expanded for DOS
  56. 5.0.
  57.  
  58. I hope you find these tools useful and convienent.  Any suggestions
  59. for enhancements, improvements or additions are welcome.  Please
  60. contact use with your comments.
  61.  
  62.  
  63. David R. Foley
  64.  
  65.  
  66. License Agreement
  67. _____________________________________________________________________
  68.  
  69.  
  70.   This software is protected by both United States' copyright law and
  71.   international treaty provisions. Therefore, you must treat this
  72.   software "just like a book," with the following single exception.
  73.   Foley Hi-Tech Systems authorizes you to make archival copies of the
  74.   software for the sole purpose of backing up our software and
  75.   protecting your investment from loss. By saying, "just like a book,"
  76.   Foley Hi-Tech Systems means that this software may be used by any
  77.   number of people and may be freely moved from one computer location
  78.   to another, provided there is absolutely no possibility of it being
  79.   used at one location while it is being used at another. Just as a
  80.   book cannot be read by two different people in two different places
  81.   simultaneously, the software may not be used by two different people
  82.   in two different places simultaneously.
  83.  
  84.   You may not make copies of the software documentation or disk,
  85.   except as described above. You may not distribute, rent, sublicense,
  86.   or lease the software or the documentation. You may not alter,
  87.   modify, or adapt the software or documentation, including but not
  88.   limited to translating, decompiling, reverse assembling, or creating
  89.   derivative works. You may not use the software in a network,
  90.   timeshareing, multiple CPU, or multi- user environment unless each
  91.   user is licensed by Foley Hi-Tech Systems.
  92.  
  93.  
  94. EXTRADOS TOOLBOX
  95. _____________________________________________________________________
  96.  
  97.  
  98. LIMITED WARRANTY
  99.  
  100.   Upon notification of defects in material or workmanship,
  101.   within the warranty period of 45 days from the date of purchase,
  102.   Foley Hi-Tech Systems will, at its option, replace the defective
  103.   diskette or refund the license fee. If you need to return a product,
  104.   call the Foley Hi-Tech Systems Technical Support Service Department
  105.   to obtain a return authorization number. The remedy for breach of
  106.   this warranty shall be limited to replacement or refund and shall
  107.   not encompass any other damages, including but not limited to loss
  108.   of profit, and special, incidental, consequential, or other similar
  109.   claims.
  110.  
  111.   Foley Hi-Tech Systems specifically disclaims all other warranties,
  112.   expressed or implied, including but not limited to implied
  113.   warranties of merchantability and fitness for a particular purpose
  114.   with respect to defects in the diskette and documentation, and the
  115.   program license granted herein in particular, and without limiting
  116.   operation of the program license with respect to any particular
  117.   application, use, or purpose. In no event shall Foley Hi-Tech
  118.   Systems be liable for any loss of profit or any other commercial
  119.   damage, including but not limited to special, incidental,
  120.   consequential, or other damages. This statement shall be construed,
  121.   interpreted, and governed by the laws of the State of California.
  122.  
  123.  
  124. TRADEMARK INFORMATION
  125.  
  126.   ExtraDOS Toolbox, TurboBAT, SpeedRAM, Screen Manager, Profiler,
  127.   WizLabel, CDBS, Press Gate Manager, ExtraWindows Toolbox and Safety
  128.   Disk are trademarks of Foley Hi-Tech Systems.
  129.  
  130.   MS-DOS and Windows are trademarks of Microsoft Corporation.
  131.  
  132.   Norton Utilities are a trademark of Symantec.
  133.  
  134.   PC-Tools is a trademark of Central Point Software.
  135.  
  136. TURBOBAT - Turbo Batch File Compiler
  137. _____________________________________________________________________
  138.  
  139.  
  140. DESCRIPTION
  141.  
  142.   TurboBAT allows you to compile standard DOS batch files into .COM
  143.   binary programs.  This will greatly enhance the speed of large batch
  144.   files by allowing them to run in native code rather than interpreted
  145.   DOS commands. The resulting .COM files may call nested batch files
  146.   without loosing the parent since the parent calling program is now
  147.   no longer a batch file.
  148.  
  149.  
  150. COMMAND FORMAT
  151.  
  152.  
  153.   TURBOBAT [/1][/4][/A][/Dname][/I][/L][/T][/X] file[.ext]
  154.  
  155.   /1      Insert single stepping code.  The creates a version of the
  156.           output that is useful when debugging a batch file.  When the
  157.           output .COM program is run, it will single step through each
  158.           line of the original program.
  159.  
  160.   /4      Supress 4DOS warning messages.  Don't report any warning
  161.           messages generated by the use of 4DOS specific commands.
  162.  
  163.   /A      Supress all warning messges (same as /4/I/L/X).  Don't
  164.           display any warning messages, only error messages.
  165.  
  166.   /Dname  Include full symbolic tracing information.  If NAME is
  167.           specified the information will be sent to the named file,
  168.           otherwise is is displayed via the standard error device.
  169.           There must not be any spaces between /D and NAME.
  170.  
  171.   /I      Ignore nonstandard labels.  DOS supports labels up to 8
  172.           characters long for use with the goto statement.  Many
  173.           people use the label as a comment field rather than a label
  174.           and this can cause problems when a label that is used in a
  175.           non standard fashion shows up during the compile stage of
  176.           the batch file. DOS will noramally just ignore this error.
  177.  
  178.   /L      Relaxed label length checking.  The normal label size
  179.           recognized by DOS is 8 characters.  In many cases people use
  180.           the : as a place holder for the program without ever
  181.           referencing the label. The problem is that if you have more
  182.           than one long label name where the first 8 digits match
  183.           another label, the file won't compile because it will look
  184.           as though you have duplicate labels.  This switch relaxes
  185.           that limit.
  186.  
  187.   /T      Compile with line number TRACE information.  The line number
  188.           information is displayed via the standard error device.
  189.           When running the output program compiled with this option on
  190.           you will get a display of each line number as the program is
  191.           running. This is useful when trying to determine where a
  192.           program is failing.
  193.  
  194.  
  195. TURBOBAT - Turbo Batch File Compiler
  196. _____________________________________________________________________
  197.  
  198.   /X      Supress extension warning messages.  Normally during
  199.           compilation, TurboBAT will warn you about any lines that
  200.           make use of commands that are supported by the compiler but
  201.           are not supported by DOS. Using the /X will tell TurobBAT
  202.           not to warn you about any BATCH files that will not function
  203.           under normal DOS conditions.
  204.  
  205.   /B-     Use ANSI escape sequences instead of the BIOS.  The default
  206.           screen I/O is now handled by making calls to the video BIOS.
  207.           This insures that the compiled batch file will work on any
  208.           machine with or without ANSI.SYS installed.  The drawback
  209.           to this is that BIOS calls are much slower than ANSI calls.
  210.           If you know that the machine that will be running the
  211.           compiled program then using the /B- command will speed up
  212.           the video calls.
  213.  
  214.  
  215. NOTES
  216.  
  217.   TurboBAT is a multipass batch file compiler.  It takes interpreted
  218.   DOS batch files and turns them into binary programs that can execute
  219.   up to as much as 4 times faster than normal batch files.  While
  220.   supporting all of the normal DOS functions that can be called from
  221.   within a batch file, TurboBAT also provides many additional features
  222.   including support for many 4DOS/NDOS commands.
  223.  
  224.  
  225. EXTENDED BATCH COMMANDS
  226.  
  227.   TurboBAT support many commands beyond those supported in normal
  228.   batch files. Some of these commands are in support of J.P. Softwares
  229.   4DOS Batch Enhancements and others are to replace small external DOS
  230.   utilities.
  231.  
  232.  
  233.  
  234. TURBOBAT - Turbo Batch File Compiler
  235. _____________________________________________________________________
  236.  
  237.  
  238. INTERNALLY SUPPORTED COMMANDS
  239.  
  240.  
  241.   DOS Commands and batch file commands that are directly supported by
  242.   TurboBAT and require no external programs are:
  243.  
  244.  
  245.   %?     "Internal" evironment variable.  Expands to the error level
  246.          of the last executed program as a string.
  247.  
  248.          Example:  SET LASTERROR=%?
  249.  
  250.  
  251.   BEEP   BEEP [frequency duration ...]
  252.  
  253.          Sounds a tone of the specified frequency for the duration in
  254.          clock ticks.  The defaults are 440Hz (A below middle C) for 2
  255.          clock ticks (about 1/4 second).
  256.  
  257.          The list of tones and durations can be repeated on a single
  258.          line. This table is identical to the 4DOS tone table:
  259.  
  260.           ╔════════╦═══════╤═══════╤═══════╤════════╤═══════╗
  261.           ║ C      ║  131  │  262  │  523  │  1040  │  2093 ║
  262.           ║ C#/Db  ║  139  │  277  │  554  │  1103  │  2217 ║
  263.           ║ D      ║  147  │  294  │  587  │  1176  │  2349 ║
  264.           ║ D#/Eb  ║  156  │  311  │  622  │  1241  │  2489 ║
  265.           ║ E      ║  165  │  330  │  659  │  1311  │  2637 ║
  266.           ║ F      ║  175  │  349  │  698  │  1391  │  2794 ║
  267.           ║ F#/Gb  ║  185  │  370  │  740  │  1488  │  2960 ║
  268.           ║ G      ║  196  │  392  │  784  │  1568  │  3136 ║
  269.           ║ G#/Ab  ║  208  │  415  │  831  │  1662  │  3322 ║
  270.           ║ A      ║  220  │  440  │  880  │  1760  │  3520 ║
  271.           ║ A#/Bb  ║  233  │  466  │  932  │  1866  │  3729 ║
  272.           ║ B      ║  248  │  494  │  988  │  1973  │  3951 ║
  273.           ╚════════╩═══════╧═══════╧═══════╧════════╧═══════╝
  274.  
  275.  
  276.   BOOT   BOOT [WARM | COLD]
  277.  
  278.          Boots the computer.  If no options are specified or if WARM
  279.          is specified a WARM boot will occur.  If COLD is specified
  280.          the computer will go through the entire cold boot process.
  281.          Under Desqview, a warm boot will only close the window.
  282.  
  283.   CDD    CDD drive:path
  284.  
  285.          Changes subdirectories and drives.  This command will change
  286.          the current directory and drive to the one specified in
  287.          [drive:path] and make the current DOS drive equal to the
  288.          value in [drive]. Normally within dos the CD command will
  289.          change directories on any drive that you specify but will
  290.          keep the current drive the same. CDD allows you to switch to
  291.          that drive rather than stay on the current drive.
  292.  
  293. TURBOBAT - Turbo Batch File Compiler
  294. _____________________________________________________________________
  295.  
  296.  
  297.   CHDIR/CD  CD path
  298.             CD drive:path
  299.  
  300.             Change the current directory as specified in path.  If a
  301.             drive is specified than change the current directory of
  302.             that drive to the directory specified in path.
  303.  
  304.   CLS       CLS [[bright] [blink] fg on bg]
  305.  
  306.             Clears the screen and optionally sets the screen color.
  307.             When setting the colors the syntax is identical to the
  308.             COLOR command.
  309.  
  310.   COLOR     COLOR [bright] [blink] fg ON bg
  311.  
  312.             Uses ANSI escape squences to set the screen color. Only
  313.             the first three letters of each command word are actually
  314.             significant.  The following colors are allowed:
  315.  
  316.               BLAck     BLUe      GREen     RED
  317.               MAGenta   CYAn      YELlow    WHIte
  318.  
  319.             Example:  COLOR BRIGHT WHITE ON BLUE
  320.  
  321.  
  322.   DELAY     DELAY [seconds]
  323.  
  324.             Pauses for the specified interval in seconds.  If no
  325.             duration is given it will pause for 1 second.
  326.  
  327.  
  328.  
  329.   ECHO      ECHO [message]
  330.  
  331.             If the /D switch was used at compile time you can enable
  332.             or disable command echoing with ECHO OFF and ECHO ON.
  333.             ECHO without any text will indicate if the /D switch was
  334.             used when the file was compiled, not the current status of
  335.             command echoing. To display a blank line use "ECHO:" or
  336.             "ECHO.".
  337.  
  338.  
  339. TURBOBAT - Turbo Batch File Compiler
  340. _____________________________________________________________________
  341.  
  342.   ECHOS     ECHOS [message]
  343.  
  344.             Displays the message without appending a cr/lf to the end
  345.             of the message like ECHO does.  (used to be ECHONLN but was
  346.             updated to match the 4DOS command.
  347.  
  348.  
  349.   ELSE      If the IFF condition was false the lines from ELSE to
  350.             ENDIFF will be executed.
  351.  
  352.             See Also IFF.
  353.  
  354.  
  355.   ELSEIFF   ELSEIFF condition [THEN]
  356.  
  357.             Similar structure to the IFF command. If the previous IFF
  358.             was false and the current condition is true the code
  359.             following will be executed to the next ELSE, ELSEIFF, or
  360.             ENDIFF statement.  Each use of ELSEIFF counts as a nesting
  361.             level.  The compiler actually converts this command into
  362.             logical ELSE^IFF^ENDIFF statements.
  363.  
  364.             See Also IFF.
  365.  
  366.   ENDIFF    Terminates an IFF statement.
  367.  
  368.             See Also IFF.
  369.  
  370.  
  371.   EXIT      EXIT is used when at the DOS level if you are running
  372.             within a shelled version of the command interpretor and
  373.             you wish to exit the shelled session.  The EXIT command is
  374.             ignored by TurboBAT. See also QUIT.
  375.  
  376.  
  377.   FOR       FOR %%var IN (file list) [DO] command
  378.  
  379.             Allows more than a single letter as the loop variable. Can
  380.             be nested.  The loop variable can be tested from other
  381.             lines by treating it as a normal environment variable.
  382.             The word "DO" is required by DOS but is optional under
  383.             4DOS and Turbobat.
  384.  
  385.  
  386. TURBOBAT - Turbo Batch File Compiler
  387. _____________________________________________________________________
  388.  
  389.   GOTO   GOTO label
  390.  
  391.          Will jump control to the label.  Labels are marked as a line
  392.          begining with a :.
  393.  
  394.  
  395.   GOSUB  GOSUB label
  396.  
  397.          Calls a label in the current batch file as a subroutine. Must
  398.          have a matching RETURN statement. The end of the batch file
  399.          does NOT act as a RETURN.
  400.  
  401.  
  402.   IF     IF [NOT] first (== | EQ | NE | LT | LE | GT | GE) second command
  403.          IF [NOT] ERRORLEVEL [== | EQ | NE | LT |LE | GT | GE] value command
  404.          IF [NOT] ENVFREE [== | EQ | NE | LT |LE | GT | GE] value command
  405.          IF [NOT] EXIST filename command.
  406.          IF [NOT] ISDIR path command
  407.  
  408.          EQ (equal), also '==' and '='
  409.          NE (not equal),
  410.          LT (less than),
  411.          LE (less or equal),
  412.          GT (greater than),
  413.          GE (greater or equal).
  414.  
  415.          If no compare command is used for ERRORLEVEL or ENVFREE the
  416.          default of GE will be used.
  417.  
  418.          EXIST tests for the existence of a file.
  419.  
  420.             IF EXIST my.cfg GOTO continue
  421.             ECHO Configuration file is missing
  422.             QUIT 99
  423.             :continue
  424.  
  425.          ISDIR tests if the given path specification is an existing
  426.          subdirectory.
  427.  
  428.             IF NOT ISDIR \work MD \work
  429.  
  430.          ENVFREE tests the available environment space.
  431.  
  432.             IF ENVFREE LT 123 ECHO Insufficient environment space
  433.  
  434.  
  435.  
  436. TURBOBAT - Turbo Batch File Compiler
  437. ___________________________________________________________
  438.  
  439.  
  440.   IFF    IFF condition [THEN]
  441.  
  442.          If the condition is true the lines up to ELSE, ELSEIFF or
  443.          ENDIFF (whichever appears first) will be executed. IFF
  444.          statements may be nested up to 15 levels deep.  See also IF.
  445.  
  446.                 IFF %? EQ 0 THEN
  447.                   GOTO CONTINE
  448.                 ELSEIFF %? EQ 99
  449.                   THEN GOTO CRITICAL
  450.                 ELSE
  451.                   GOTO ERROR
  452.                 ENDIFF
  453.  
  454.  
  455.   INKEY  INKEY [/Wn] [message] %%var
  456.  
  457.          Gets a single keystroke and places it in the environment.
  458.          %%var is the environment variable that will be assigned the
  459.          keystroke. If /W is specified the command will wait up to
  460.          that many seconds, e.g. /W10. It will also optionally display
  461.          a message.  If a wait of zero is used (/W0) the command will
  462.          return immediately if no keystrokes are pending.  The wait
  463.          period can be specified in the environment, but the /W but be
  464.          present on the line at compile time, e.g.:
  465.  
  466.              inkey /w%delay Press any key: %%key
  467.  
  468.          Displayable keystrokes (characters above the space) are
  469.          stored as their corresponding character.  Keystrokes that do
  470.          not have a corresponding character are displayed as a number,
  471.          e,g. the carriage return as "13".  Extended keystrokes such
  472.          as F1 are stored with a preceding '@', (@59 for F1).
  473.  
  474.  
  475.   INPUT  INPUT [/Wn] [message] %%var
  476.  
  477.          Gets a string and places it in the environment.  %%var is the
  478.          environment variable that will be assigned the string.  The
  479.          string is terminated by a carriage return or end of file mark
  480.          (^Z).  Extended keystrokes are ignored.  /Wn is the optional
  481.          maximum time in seconds to wait for the first keystroke.
  482.          Once a keystroke is entered this command will not time out.
  483.  
  484.   MKDIR  MKDIR [pathname]
  485.   MD     MD [pathname]
  486.  
  487.          Will create a new directory of PATHNAME.
  488.  
  489.  
  490.   PATH   Displays or Sets the Path.
  491.  
  492.  
  493. TURBOBAT - Turbo Batch File Compiler
  494. ___________________________________________________________
  495.  
  496.  
  497.  
  498.   PAUSE   PAUSE [message]
  499.  
  500.           Displays an optional message.  If no message is specified the
  501.           default of "Press a key when ready..." is used.  In addition,
  502.           a CR/LF is not output until after the key is pressed.
  503.  
  504.  
  505.   PROMPT  Displays or Sets the DOS Prompt
  506.  
  507.  
  508.   QUIT    QUIT [exitcode]
  509.  
  510.           Unconditionally halts the compiled batch file.  If no
  511.           exitcode is specified, zero will be used.  The exit code can
  512.           refer to an environment variable.  If the variable is not a
  513.           number or does not exist zero will be used.  Examples:
  514.  
  515.                 SET var=1
  516.                 QUIT %var
  517.  
  518.           Exits with 1.
  519.  
  520.                 SET var=test
  521.                 QUIT %var
  522.  
  523.           Exits with 0 because %var is not a number.
  524.  
  525.  
  526.   REM     REM is the standard DOS Remark field.  REM lines are ignored
  527.           by the TurboBAT Compiler.
  528.  
  529.  
  530.   REPEAT/
  531.   UNTIL   Similar to the Pascal structure.  May be nested up to 15
  532.           deep. Redirection is not allowed on a line containing REPEAT
  533.           or UNTIL.
  534.  
  535.                 REPEAT
  536.                   ECHO %1
  537.                   SHIFT
  538.                 UNTIL "%1" EQ ""
  539.  
  540.  
  541.   RETURN  Return from a subroutine call.  If no subroutines are
  542.           pending it will terminate the batch file with an exit code of 255.
  543.  
  544.   RD
  545.   RMDIR   Remove Directory.  This will remove the directory specified
  546.           as long as there are no files in it.
  547.  
  548.  
  549.  
  550.  
  551. TURBOBAT - Turbo Batch File Compiler
  552. _____________________________________________________________________
  553.  
  554.  
  555.   SCREEN  SCREEN row column [message]
  556.  
  557.           Positions the cursor using ANSI sequences and displays an
  558.           (optional) message.  The cursor coordinates are 0 based, the
  559.           normal range being 0-24 rows and 0-79 columns.
  560.  
  561.  
  562.   SCRPUT  SCRPUT row col [bright][blink] fg ON bg message
  563.  
  564.           Writes the message at the specified screen coordinates using
  565.           the specified colors.  The cursor position is restored to
  566.           the position before the command.  ANSI escape sequences are
  567.           used throughout.
  568.  
  569.   SET     Alone, Set will display the current environment variables,
  570.           or followed by an environment variable, set will set the
  571.           environment variable to the given value.
  572.  
  573.  
  574.   SHIFT   Same as standard DOS.  I will be expanding this command for
  575.           4DOS compatibility to accept a shift factor, with support
  576.           for a negative number which will get back previously shifted
  577.           parameters.
  578.  
  579.   SINGLESTEP    SINGLESTEP ON | OFF
  580.  
  581.           Enables or disables single stepping.  The /1 compiler switch
  582.           must be used for this command to have any effect.  The
  583.           options are resolved at compile time so you can not use an
  584.           environment variable or command line parameter to set the
  585.           status.
  586.  
  587.  
  588.  
  589.   TEXT/
  590.   ENDTEXT The text that follows, up to ENDIFF will be displayed as if
  591.           each line was preceded by an ECHO. Output redirection is
  592.           more efficient using this command instead of individually
  593.           redirected ECHO commands since the file will only be opened
  594.           and closed once, while the file will be opened and closed
  595.           for each ECHO command.
  596.  
  597.                 TEXT
  598.                 This could be a menu
  599.                 or it could be help information
  600.                 ENDTEXT
  601.  
  602.                 TEXT >dummy
  603.                 This text will be sent to the redirection file.
  604.                 Up to, but not including the ENDTEXT command.
  605.                 ENDTEXT
  606.  
  607.  
  608.  
  609. TURBOBAT - Turbo Batch File Compiler
  610. _____________________________________________________________________
  611.  
  612.  
  613.   UNSET   Deletes the environment variable from the master environment.
  614.  
  615.                 UNSET RESULT
  616.  
  617.  
  618.   WHILE/
  619.   WEND    Similar to the Pascal structure. May be nested up to 15
  620.           deep. Redirection is not allowed on a line containing WHILE
  621.           or WEND.
  622.  
  623.                 WHILE "%1" NE ""
  624.                   ECHO %1
  625.                   SHIFT
  626.                 WEND
  627.  
  628.  
  629.  
  630.  
  631.  
  632. COMMANDS HANDLED BY CALLING THE COMSPEC
  633.  
  634.  
  635.   These commands are supported by calling COMMAND.COM:
  636.  
  637.   CALL, DIR, DEL, REN, VER, VOL, CTTY, CHCP, TYPE, COPY, DATE, TIME,
  638.   ERASE, BREAK, RENAME, DELETE, VERIFY, COMMAND
  639.  
  640.  
  641.   These commands will only work if 4DOS is the active COMSPEC:
  642.  
  643.   FREE, DRAWBOX, DRAWHLINE, DRAWVLINE, MEMORY
  644.  
  645.  
  646.  
  647. TURBOBAT - Turbo Batch File Compiler
  648. _____________________________________________________________________
  649.  
  650. COMPILER ERROR MESSAGES
  651.  
  652.   TurboBat contains a library of internal error messages and will
  653.   display the error number and message when an error or warning is
  654.   found.  Files with just warnings will compile, files with errors
  655.   will not compile.
  656.  
  657.   Warning Messages / Error Messages
  658.  
  659.    1  Duplicate label
  660.  
  661.       Each label must be unique for a file to compile correctly.  Use
  662.       the /I to relax label checking when using the : for marking
  663.       comments.
  664.  
  665.  
  666.    2  Duplicate label (check size)
  667.  
  668.       Sometimes labels are used as comments in batch files.  If a
  669.       label is unique, but after the 8th character the compiler won't
  670.       pick it up as unique since DOS only supports the first 8
  671.       characters of a label.  You can use the /L option to relax label
  672.       length checking.
  673.  
  674.  
  675.    3  Redirection not allowed here
  676.  
  677.       TurboBAT does not support the redirection of output or input at
  678.       the location specified.
  679.  
  680.  
  681.    4  Invalid IF statement
  682.  
  683.       The IF statement is using invalid syntax, check the manual for
  684.       usage of IF and IFF commands.
  685.  
  686.  
  687.    6  Invalid FOR statement
  688.  
  689.       The FOR statement is using invalid syntax, check the manual for
  690.       the usage of the FOR command.
  691.  
  692.  
  693.    7  EXIT can not be used in a compiled batch file
  694.  
  695.       EXIT is normally used to abort a batch file at any location.
  696.       You can not do this with a compiled batch file.  Replace usage
  697.       of EXIT with a GOTO command that jumps to a label at the end of
  698.       the batch file.
  699.  
  700.    8  Label not Found.
  701.  
  702.       A reference was made to a label that does not exist.
  703.  
  704.  
  705. TURBOBAT - Turbo Batch File Compiler
  706. _____________________________________________________________________
  707.    9  Program is too large
  708.  
  709.       The output of the compiled batch file is exceeding 64k bytes.
  710.       TurboBAT currently only supports the .COM format of programs
  711.       under 64k bytes large.  Reduce the commands in your batch file
  712.       if possible.
  713.  
  714.  
  715.   10  REPEAT nested too deeply
  716.  
  717.       You have too many levels of nesting with a REPEAT Loop.  Try
  718.       breaking the repeat loop out of a nested piece of code.
  719.  
  720.  
  721.   11  Unmatched UNTIL
  722.  
  723.       The UNTIL statement found has no opening REPEAT command.
  724.  
  725.  
  726.   12  WHILE nested too deeply
  727.  
  728.       You have too many levels of nesting with a WHILE Loop.  Try
  729.       breaking the while loop out of a nested piece of code.
  730.  
  731.  
  732.   13  Unmatched WEND
  733.  
  734.       The WEND statement found has no opening WHILE command.
  735.  
  736.  
  737.   14  Label longer than nn characters, truncated
  738.  
  739.       Labels that are longer than supported by TurboBAT will be
  740.       truncated to the maximum characters allowed.
  741.  
  742.  
  743.   15  IFF nested too deeply
  744.  
  745.       You have too many levels of nesting with an IFF Loop.  Try
  746.       breaking the iff loop out of a nested piece of code.
  747.  
  748.  
  749.   16  Unmatched ELSE statement
  750.  
  751.       The ELSE statement found has no opening IF or IFF command.
  752.  
  753.  
  754.   17  Unmatched ENDIFF statement
  755.  
  756.       The ENDIFF statement found has no opening IFF command.
  757.  
  758.   18  Unexpected end of file, no matching ENDTEXT
  759.  
  760.       A TEXT command was used without an ENDTEXT command and TurboBAT
  761.       read to the end of the input file before finding an ENDTEXT and
  762.       could not finish the compile.
  763.  
  764. TURBOBAT - Turbo Batch File Compiler
  765. _____________________________________________________________________
  766.  
  767.  
  768.   19  Unmatched ENDTEXT
  769.  
  770.       The ENDTEXT statement found has no opening TEXT command.
  771.  
  772.  
  773.   20  Syntax error
  774.  
  775.       Invalid command syntax was used.  Consult the TurboBAT manual
  776.       for command usage.
  777.  
  778.  
  779.   21  4DOS Specific command used
  780.  
  781.       A command was used that is normally only supported by the use of
  782.       4DOS.  Make sure that the target system has 4DOS installed or
  783.       the resulting .COM file may not work properly.
  784.  
  785.  
  786.   22  TurboBAT extension used
  787.  
  788.       This is notifying you that a non standard command was used
  789.       inside the batch file.  There is no problem with this usage,
  790.       except that the .BAT file might not work unless compiled with
  791.       TurboBAT.
  792.  
  793.  
  794.   23  Open REPEAT statement
  795.  
  796.       A REPEAT command was used with no UNTIL command to close it.
  797.  
  798.  
  799.   24  Open WHILE statement
  800.  
  801.       A WHILE command was used with no WEND command to close it.
  802.  
  803.  
  804.   25  Open IFF/ELSEIFF statement
  805.  
  806.       An IFF or ELSEIFF statement was used with no ENDIFF to close it.
  807.  
  808.  
  809.   26  Command not supported in this version of Turbobat
  810.  
  811.       A command was used that is not supported by TurboBAT.  Contact
  812.       Foley Hi-Tech Systems for details on solving this problem.
  813.  
  814.  
  815.   99  Internal error - please contact Foley Hi-Tech Systems
  816.  
  817.       An internal processing error has occured with TurboBAT.  Contact
  818.       Foley Hi-Tech Systems technical support.
  819.  
  820.  
  821.  
  822. TECHNICAL SUPPORT
  823. _____________________________________________________________________
  824.  
  825.  
  826.   Often we get calls from people asking questions that can be
  827.   solved easily by checking through the manual before calling tech
  828.   support. We ask that you browse the manual and look for information
  829.   pertaining to your particular problem before calling. This can often
  830.   save you time, as we take a collection of our most common questions
  831.   and try to address them in this manual.
  832.  
  833.   We offer alternative methods besides the conventional phone
  834.   support, such as a multi-line 24-hour BBS system. We also monitor
  835.   most technical conferences in the BBS Interlink and RelayNet
  836.   networks as well as many conferences on the CompuServe
  837.   Information System. You may send messages and questions via any of
  838.   these services.
  839.  
  840.   Currently our Tech Support office is staffed Monday through Friday
  841.   from 9:00 a.m. to 5:00 p.m. Pacific Time. There is a chance,
  842.   however, that someone is in the office outside this time frame.
  843.   If so, we will gladly answer your questions outside the normal
  844.   business hours.  Registered users are given unlimited technical
  845.   support.
  846.  
  847.   Foley Hi-Tech Systems
  848.   Technical Support Department
  849.   185 Berry Street
  850.   San Francisco, CA  94107
  851.   (415) 882-1730
  852.   (415) 882-1733 FAX
  853.   (415) 882-1735 BBS
  854.   70262,1463 CompuServe
  855.  
  856.  
  857.  
  858. CREDITS
  859. _____________________________________________________________________
  860.  
  861.  
  862.   This collection of utilities started out as a small set of home
  863.   grown tools that I just could not stand to live without.  Many times
  864.   someone would see me using them and ask for a copy.  This was a big
  865.   mistake.  All of the sudden I had to debug my code.  Someone would
  866.   call me up and remind me of some problem with a utility that I had
  867.   written or asked me to just add this one little feature.  Six years
  868.   later the package has evolved to its current state.  Along the way I
  869.   have had the help of many people in testing and ideas for products.
  870.   I would like to thank all of those people who have of course
  871.   registered these utilities as this is now a new incentive for
  872.   continuing to expand them.  More specifically I'd like to thank the
  873.   following:
  874.  
  875.   Kathy Smith
  876.   Jay Wessel
  877.   Roger Cross
  878.   Brian & Tess for Channel 1
  879.   Paul Somerson & Bantam Books
  880.   PC Tech Journal (A Great Loss)
  881.   PC Magazine
  882.   Byte Magazine
  883.   Jerry Pournelle
  884.   Association of Shareware Professionals
  885.  
  886.  
  887.  
  888.  
  889. PROGRAMMING
  890.  
  891.   The ExtraDOS Toolbox utilties use a wide variety of programming
  892.   tools including:
  893.  
  894.   Borland Turbo Pascal 6.0
  895.   Borland Turbo Assembler 3.0
  896.   Borland Turbo C++ 1.0
  897.   Borland Turbo Debugger 2.0
  898.   Turbo Power Software Object Professional 1.0
  899.   Phil Katz' PKLite Professional 1.13
  900.   Unity Programmers Editor 3.33
  901.   Ralph Browns' Interrupt List
  902.  
  903.  
  904.   Programming by:
  905.  
  906.   Mike Blaszczak
  907.   David Foley
  908.   Joe Halpin
  909.   Bill McKee
  910.   Mike Molloy
  911.   Mike Viens
  912.   Ross Wentworth
  913.   Randall Woodman
  914.  
  915.  
  916. CREDITS
  917. _____________________________________________________________________
  918.  
  919.  
  920.  
  921. ART
  922.  
  923.   Artwork for the ExtraDOS Toolbox was created using:
  924.  
  925.   Ian Davis' TheDraw 4.01
  926.   Aldus Freehand 2.0
  927.   Electronic Arts Studio/8 2.0
  928.  
  929.  
  930.   Art by:
  931.  
  932.   David Foley
  933.   Noel Gamboa
  934.   Moses Gates
  935.   Shahasp Herardian
  936.   Pat McSween
  937.   Ross Wentworth
  938.  
  939.  
  940. DOCUMENTATION
  941.  
  942.   Documentation for the ExtraDOS Toolbox was written using:
  943.  
  944.   FHTS SuperEdit 3.04
  945.   Word Perfect 5.1
  946.   MS Word for Windows 2.0
  947.   Grammatik for Windows 1.0
  948.   Aldus Pagemaker 4.0
  949.   Unity Programmers Editor 3.33
  950.  
  951.  
  952.   Documentation by:
  953.  
  954.   Mike Blaszczak
  955.   David Foley
  956.   Mike Viens
  957.   Ross Wentworth
  958.  
  959.  
  960.   Printed Manuals by:
  961.  
  962.   BindCo, Brisbane, CA.
  963.  
  964.  
  965. LICENSE INFORMATION
  966.  
  967.   CHIMES, EVAL and RAMDRIVE are derivatives of the Nifty James
  968.   utilties by Mike Blaszczak.
  969.  
  970.   FILEATTR, NAMEDIR and SWAPFILE are derivatives of the Fantastic
  971.   Utilities by Mike Viens.
  972.  
  973.  
  974. FHTS Products
  975. _____________________________________________________________________
  976.  
  977.  
  978. Safety Disk (tm)
  979.  
  980.   Safety Disk saves all of your systems vital information and will
  981.   solve most problems due to:  Loss of battery power, Loss of CMOS
  982.   information, accidental deletion of boot files, virus damage to boot
  983.   disk.
  984.  
  985.  
  986.   "Use Safety Disk and your PC is Safe.", Computer Shopper, March 1992
  987.  
  988.   "Used in Conjuntion with a conventional backup utility, Safety Disk,
  989.    for $59.95 will provide as bulletproof a backup as you're likely to
  990.    find in the PC marketplace.", InfoWorld, February 10, 1992
  991.  
  992.   "Safety Disk is so deceptively easy to use that it makes hard-drive
  993.    and computer maintenance seem impossibly easy.", PCM Magazine, May
  994.    1992
  995.  
  996.   "I have discovered the most unique and useful system maintenance
  997.    utility since Spinrite came along.", MBUG PC Newsletter, December,
  998.    1991
  999.  
  1000.  
  1001. ExtraDOS Toolbox (tm)
  1002.  
  1003.   A large collection of over 50 utilities that DOS forgot. Includes
  1004.   many helpful utilities that enhance MS-DOS machines. Featured in the
  1005.   DOS Power Tools, 2nd Edition, Revised for DOS 5.0 book by Bantam
  1006.   Books.
  1007.  
  1008.  
  1009. WizLabel (tm)
  1010.  
  1011.   Print Sharp Wizard phone listings directly to your SLP Printer
  1012.   without having to convert your data.
  1013.  
  1014.  
  1015. Coach Database System■.
  1016.  
  1017.   CDBS provides a method for tracking and evaluating NBA teams, NBA
  1018.   players, and college players. It supplies a comprehensive report
  1019.   generator for building decision support reports on scouted players.
  1020.  
  1021.  
  1022. FHTS Products
  1023. _____________________________________________________________________
  1024.  
  1025.  
  1026.  
  1027. Press Gate Manager■.
  1028.  
  1029.   Software for event organizers. Creates and maintains a database of
  1030.   events and guests with the ability to track seating by type,
  1031.   location, and person. Produces seating charts and labels for press
  1032.   passes.
  1033.  
  1034.  
  1035. FINDB■.
  1036.  
  1037.   Financial Database System for tracking shareholders in a company.
  1038.   Allows the instant retrieval of information based on any part of a
  1039.   persons account id, ss#, zip code etc.  Has support for completely
  1040.   customized HP Laserjet tax forms.  Ideal for generating K1 tax
  1041.   reports for limited partnerships.
  1042.  
  1043.  
  1044.  
  1045. EXTRADOS TOOLBOX UPCOMING ADDITIONS
  1046. _____________________________________________________________________
  1047.  
  1048.  
  1049. We are constantly adding new utilities to the ExtraDOS Toolbox
  1050. collection.  Some are developments of ideas from our customers.  If
  1051. you know of a utility that you would find handy or updates to
  1052. existing utilities please let us know about them.
  1053.  
  1054.  
  1055. BATPLUS     Collection of enhancements for DOS Batch files.  BATPLUS
  1056.             enhancements will also be supported by TurboBAT.
  1057.  
  1058. BOOTLOCK    Updates to BootLock to make it a Device Driver or TSR.
  1059.  
  1060. BOOTMGR     Boot Manager will allow you to choose from many different
  1061.             boot up configurations by displaying a menu of choices
  1062.             at boot time.  Each configuration can have a seperate
  1063.             AUTOEXEC.BAT and CONFIG.SYS associated with it.
  1064.  
  1065. DIALIT      Small TSR that allows you to pop up over any text screen
  1066.             and capture a phone number and then dialing with your
  1067.             modem.
  1068.  
  1069. DIFF        Full screen file comparison utility.  Will display the
  1070.             differences between two different files.
  1071.  
  1072. DIRSORT     Sort directories by Name, Extension, Date, Time or Size.
  1073.  
  1074. DISKTEST    Command line utility to perform testing functions on disk
  1075.             drives looking for bad sectors or clusters.
  1076.  
  1077. EMSX86      EMS 4.0 Memory Manager that converts Extended Memory into
  1078.             LIM EMS 4.0 Expanded memory.
  1079.  
  1080. FKEYSET     Allows you to assign customized values for all the function
  1081.             keys.
  1082.  
  1083. KBDMGR      Keyboard Manager allows you to customize the repeat rate
  1084.             of keys as well as expanding the typeahead buffer.  Also
  1085.             features custom key clicking options.
  1086.  
  1087. LQPRINT     Allows 9 pin dot matrix printers to print near letter
  1088.             quality output by converting text into high resolution
  1089.             graphics.
  1090.  
  1091. NBSTIME     Will set your PC clock to National Atomic Clock time by
  1092.             calling NBS with your modem.
  1093.  
  1094. PRMPTMGR    Prompt Manager gives you access to a library of DOS prompts
  1095.             and allows you to create your own DOS prompts.
  1096.  
  1097. PRINTCTL    Print Controller is a multiple printer spool and configuration
  1098.             utility.  Supports EMS or DISK spooling and up to three
  1099.             printer ports.
  1100.  
  1101.  
  1102. EXTRADOS TOOLBOX UPCOMING ADDITIONS
  1103. _____________________________________________________________________
  1104.  
  1105.  
  1106. SORT        Advanced SORT utilty for DOS.  Features many enhancements o
  1107.             over the DOS version.
  1108.  
  1109. SPEEDFL     Increase access to some floppy disk drives.
  1110.  
  1111. SPLITFL     Split files into multiples for modem or diskette transfers.
  1112.  
  1113. STOPWTCH    Stop Watch allows you to time programs at the DOS prompt.
  1114.  
  1115. SWAPFILE    Swap to file names with the associated files.
  1116.  
  1117. XCD         Smart CHDIR command.  Will accept partial names.
  1118.  
  1119. XDEL        Advanced delete command.  Allows many options and exclusions.
  1120.  
  1121. XDIR        Updated DIR command with sort options.
  1122.  
  1123. ZIPCODE     TSR to allow the searching of US Postal Zip Code Database.
  1124.  
  1125.  
  1126.  
  1127.  
  1128.   The latest versions of the ExtraDOS Toolbox utilities can be found on:
  1129.  
  1130.   FHTS PC GURU III BBS, San Francisco, CA  (415) 882-1735
  1131.  
  1132.   CHANNEL 1 BBS, Cambridge, MA             (617) 354-8873
  1133.  
  1134.   COMPUSERVE INFORMATION SERVICE           See CIS Listings
  1135.  
  1136.